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1.1. Introduction 

1.2. Non-Issues 
Word Size 

Byte Ordering 


1 


Machine Architecture 


This document is intended for programmers who are porting programs written in 
C, FORTRAN, or Pascal from Sun-2 or Sun-3 machines to SPARC systems. The 
acronym SPARC stands for Scalable Processor ARChitecture. SPARC is a RISC 
(Reduced Instruction Set Computing) architecture easily scalable to new techno- 
logies, and is described in the SPARC Processor Architecture manual. 

Here are some common porting considerations that are not of concern here. 

Both the Sun-2, based on the Motorola MC68010 CPU, and the Sun-3, based on 
the MC68020, are 32-bit machines. That is, integers are 32 bits long. Since 
SPARC is a 32-bit architecture, word size is not an issue. 

Both the MC68010 and the MC68020 have forward byte ordering but reverse bit 
ordering. In other words, the MC680x0 is big-endian with respect to bytes, but 
little-endian with respect to bits. The same is true of SPARC machines. Thus, 
byte ordering is not an issue. 

By contrast, the VAX and the Intel 80386 have both reverse byte ordering and 
reverse bit ordering. In other words, they are little-endian architectures. The 
IBM 360, on the other hand, has both forward byte ordering and forward bit 
ordering. In other words, it is a big-endian architecture. 

Figure 1-1 Forward Byte and Backward Bit Ordering (MC 680x0 & SPARC) 
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Figure 1-2 Backward Byte and Bit Ordering (VAX & 80386) 
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Figure 1-3 Forward Byte and Bit Ordering (IBM 360) 
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2 Porting Software to SPARC 


Scalar Representation 


1.3. How to Read this 
Document 


The bit and byte ordering of the VAX, Intel 80386, and IBM 360 are not relevant 
when porting from the Motorola 680x0 to SPARC systems. They are mentioned 
only for comparison. Also, note that the difference in bit ordering between the 
MC680x0 and the IBM 360 is purely notational. That is, on the MC680x0 the bit 
named 0 is the least significant, but on the IBM 360 the bit named 31 is the least 
significant. These bits have the same numeric value, but different names. 

Both the MC680x0 and SPARC machines use two’s-complement integers, and 
standard IEEE floating-point single- and double-precision representations. So 
scalar data representation is not an issue. 

The next chapter describes issues you may encounter when porting C programs 
to SPARC systems. The chapter after that covers the porting of FORTRAN pro- 
grams. The last chapter talks about porting Pascal programs to SPARC systems. 
You may read only the material that concerns you. 
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2.1. Porting Issues 


Data Alignment 


Porting C Programs 


Here are some architectural considerations that you should be aware of when 
porting C programs to SPARC machines. Fortunately you can pinpoint most of 
these problems with lint -ch. The -c flag detects unportable casts, and the - 
h flag performs heuristic checking. 

On the MC680x0, characters are aligned on byte boundaries, and everything else, 
regardless of size, is aligned on halfword (even) boundaries. On SPARC 
machines, all quantities must be aligned on boundaries corresponding to their 
sizes: bytes on byte boundaries, (16-bit) halfwords on halfword boundaries, (32- 
bit) words on word boundaries, and (64-bit) doublewords on doubleword boun- 
daries. If you are coding in assembly language, you must observe alignment res- 
trictions. Otherwise, compilers normally keep track of everything for you. There 
are several C language constructs, however, that may lead to a bus error during 
execution: 

□ Casting a pointer to a char or unsigned char into a pointer to a larger 
quantity, such as a short, int, long, float, double, or struct/- 
union containing one of these. This includes passing a char * as an argu- 
ment to a function expecting a pointer to a larger quantity. 

□ Casting a pointer to a short or unsigned short into a pointer to a 
larger quantity, such as an int, long, float, double, or struct/- 
union containing one of these. This includes passing a short * as an 
argument to a function expecting a pointer to a larger quantity. 

□ Casting a pointer to a 32-bit quantity (such as an int, unsigned int, or 
float) into a pointer to a (64-bit) double or struct /union containing 
a double. This includes passing a pointer to a 32-bit quantity as an argu- 
ment to a function expecting a pointer to a double. C programmers should 
note that float * and double * are not the same. 

The above constructs may work occasionally, if the pointer happens to end up on 
the right boundary. But more often, these constructs lead to bus errors. It is not 
the cast itself that causes the bus error, but rather dereferencing the resulting 
pointer. The use of lint should catch most of these problems. 
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4 Porting Software to SPARC 


Structure Alignment and Structure Alignment. On the MC680x0, each structure is aligned on a halfword 

Padding (even) boundary. On SPARC machines, the alignment requirement for a struc- 

ture is the same as that of its most strictly aligned component. For instance, a 
struct containing only char members has no alignment restrictions, whereas 
a struct containing a double must be aligned on an 8-byte boundary. 

Internal Padding. On the MC680x0, structures are padded internally so that 
integers and floats always begin on an even boundary. On SPARC machines, 
structures are padded internally so that every element is aligned on the appropri- 
ate boundary. For instance, a struct containing only one char and then a 
long has three bytes of padding after the char, so that the long is aligned on a 
4-byte boundary. 

Tail Padding. On the MC680x0, structures are padded on the end to contain an 
even number of bytes. On SPARC machines, structures are padded on the end to 
the appropriate alignment boundary. For instance, a struct containing only 
char members is unpadded, whereas a struct containing an int but no dou- 
ble is padded out to a 4-byte boundary. 

Because of the three considerations above, members of a given structure may 
have different offsets on SPARC machines than on the MC680x0, and the struc- 
ture as a whole may have a different size. Even though data representations are 
identical on the MC680x0 and SPARC, binary files where raw structures have 
been written out may not be portable between processors. Note that structures 
retained in memory are fine; problems occur only when raw structures are written 
to disk or across the network. 

Here is an example of two structures that could not be written on one processor 
and read on the other (though in memory they would be fine): 

Figure 2-1 Structures that Result in Non-Portable Binary Files 
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There are three solutions to this problem. First, you could write a program to run 
on each processor to create binary files of structures according to the require- 
ments of that processor. For example, the makedev program used with device- 
independent trof f writes out the font information structures on each machine 
running trof f . 
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Chapter 2 — Porting C Programs 5 


Function Return Values 


Passing Mismatched 
Parameter Types 


Second, if a structure must be portable across machines, Sun’s external Data 
Representation (XDR) is the best solution. The best way to write a record on one 
machine that is to be read on others is to use an XDR standard representation for 
the data. See the section entitled “XDR Protocol Specification” in the manual 
Networking Programming on the Sun Workstation. 

Third, you could manually arrange the members of a structure, from the most to 
least restrictive alignment requirements, then insert explicit fill (padding) ele- 
ments as needed. Structures are often designed in this manner anyway, with the 
largest elements at the beginning. 

On SPARC machines, if a function is going to return a structure by value, both 
the calling function and the called function must agree on its type. If the called 
function returns a structure by value but the calling function doesn’t use it, no 
harm is done. The value is returned, but the calling function ignores it. If the 
called function does not return a structure by value but the calling function 
expects one, you get an “Unimplemented Instruction Trap” at runtime upon 
return from the called function. The use of lint should catch these problems. 

The C language does not define what happens when you pass a list of variables to 
a routine that receives a struct by value, or vice versa. This just happened to 
work with Sun’s MC680x0 C compilers. On SPARC machines, it does not work. 
Here is an example that won’t work on SPARC: 


— 


struct thing { 


int x, y; 


}; 


int a, b; 


routine (s) 


struct thing s; 


routine (a, b) ; 


V 

J 


Likewise, on SPARC machines, passing a union by value is not equivalent to 
passing one of its elements (use of lint should catch this). Here is a construct 
that won’t work on SPARC: 


— 

A 

union thing { 


int i; double x; 


} combo ; 


routine (x) 


double x; 


routine (combo) ; 


V 

J 
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6 Porting Software to SPARC 


Parameter Passing: 
varargs ( ) 


Order of Parameter 
Evaluation 


Passing Union Arguments 
semctl () 


Stack Allocation with 
alloca () 


Out-of-Range Shifts 


Uninitialized Automatic 
Variables 


Taking the address of a function parameter and manipulating it to access other 
parameters (or other data) on the stack is possible with Sun’s MC680x0 C com- 
pilers. With SPARC compilers, however, routines that receive a context- 
dependent number of arguments of varying types must be written using the mac- 
ros defined in <varargs . h>. These macros permit you to write even such rou- 
tines as printf ( ) portably. See the varargs(3 ) manual page for details. 

The order of evaluation of parameters to a function is not defined by the C 
language, and is different in SPARC C compilers than in Sun’s MC680x0 C 
compilers. Let’s consider this example: 

/ — ' 

func(x * i, y / i, i++) ; 

^ 

Since the arguments of f unc ( ) are evaluated in a different order on SPARC 
systems than on Sun-2 or Sun-3 machines, the side effect caused by i++ is going 
to yield different results on different machines. It is never a good idea to make 
assumptions about the order of parameter evaluation. The best strategy is to 
write C code that does not depend on any side effects of parameter evaluation. 

to Users of the System V semaphore facility may have to modify code that worked 
on other machines for SPARC. With the semct 1(2) system call, the subcom- 
mands SETVAL, GETALL, SETALL, IPC_STAT, and IPC_SET require a 
fourth argument semun, which is a union. Programs that call semctl ( ) with 
these subcommands must pass the union itself, rather than an element of the 
union, or a constant such as 0 (zero). Programs that call semctl ( ) with other 
subcommands should omit the fourth argument, rather than pass a constant such 
as 0 (zero). As usual, lint helps you spot problems of this kind. 

On SPARC systems, users of the stack allocation routine alloca ( ) must 
include the header file <alloca . h> before using the routine. Furthermore, 
since alloca ( ) is now built in to the compiler, it cannot be assigned to an int 
( * ) ( ) variable, nor can it be passed as a procedure-type parameter. 

Using the C language bit-wise shift operators «, », «=, or »= with a right- 
hand operand greater than or equal to the size of the left-hand operand (in bits) 
yields machine-dependent results. Many programmers are not aware of this, and 
assume that an unsigned shift by a large amount yields zero. This is often true on 
MC680x0 machines, because the shift count is interpreted modulo 64. This is 
true less often on SPARC machines, because the shift count is interpreted 
modulo 32. The best strategy is to avoid shift counts greater than the size of the 
affected operand. A negative shift count won’t yield sensible results on either 
machine, of course. 

Naturally, beware of uninitialized local variables; they may have different values 
on different machines, and in different calls to the same function. The use of 
uninitialized automatic variables continues to be a poor programming practice. 
Fortunately, the use of lint should detect such problems. 
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Chapter 2 — Porting C Programs 7 


2.2. Conclusion Well-written portable C programs should compile and run on SPARC machines 

as well as on other machines. Non-portable programs, by definition, may present 
problems when transported to SPARC machines, or to any other machine. There 
is no substitute for good program design and judicious use of lint . 



microsystems 


Revision A, of 9 May 1988 



8 Porting Software to SPARC 



Revision A, of 9 May 1988 


3 


Porting FORTRAN Programs 


3.1. Porting Issues In general, there are fewer potential areas of concern in porting FORTRAN pro- 

grams to SPARC than there are porting C programs. Data alignment is not a 
problem, because FORTRAN has no type casting mechanism. Binary reads and 
writes are done byte-by-byte, so structure padding is not a concern. FORTRAN 
has no structures, no unions, and no mechanism for variable-length argument 
lists, so these do not pose portability problems, either. 

The EQUIVALENCE statement and the COMMON block, and the order of parame- 
ter evaluation, are perhaps the only potential problem areas. 

The EQUIVALENCE The use of EQUIVALENCE can force double-precision variables to be 

Statement misaligned, as in the following FORTRAN code: 


— 

REAL A (5) 

DOUBLE PRECISION D(4) 

\ 

EQUIVALENCE (A (2 ) , D ( 1) ) 

k 

J 


Note that the 8-byte doubleword D ( 1 ) does not begin on an 8-byte boundary 
owing to the EQUIVALENCE, even though it would be much more efficient for 
D ( 1 ) to be aligned on an 8-byte boundary. 


Figure 3-1 Alignment Problems with EQUIVALENCE 
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Because this usage of EQUIVALENCE is standard FORTRAN, the FORTRAN 
compiler must deal with it. When an EQUIVALENCE statement skews align- 
ment, the compiler generates code to access double-precision variables as pairs 
of single-precision variables. These variables are loaded and stored with word 
instructions, rather than with doubleword instructions. Unfortunately this slows 
down execution somewhat, so for the sake of efficiency, it is best not to 
equivalence variables without regard for data alignment. 
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10 Porting Software to SPARC 


The COMMON Block 


Order of Parameter 
Evaluation 


The placement of odd-length single-precision arrays before double-precision 
arrays in a COMMON block can also force double-precision variables to be 
misaligned, as in the following FORTRAN code: 


r 


REAL A (3) 

DOUBLE PRECISION D(3) 


COMMON A, D 


V 

y 


Note that the 8-byte word D ( 1 ) does not begin on an 8-byte boundary because 
of the COMMON block ordering, even though it would be much more efficient for 
D ( 1 ) to be aligned on an 8-byte boundary. 


Figure 3-2 Alignment Problems with COMMON 
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Because this usage of COMMON is standard FORTRAN, the FORTRAN compiler 
generates code to access double-precision elements of array D as pairs of single- 
precision variables. These variables are loaded and stored with word instruc- 
tions, rather than with doubleword instructions. Unfortunately this slows down 
execution somewhat. The best fix is to get into the habit of placing double- 
precision variables first in a COMMON block. 

The order of evaluation of parameters to a FORTRAN function or subroutine is 
different on SPARC than on the Sun-2 or Sun-3. Let’s consider this example: 

r ' 

call tally(f(x), g(x)) 

■ 

Since the functions f ( ) and g ( ) , which are arguments of subroutine tally () , 
are evaluated in a different order on SPARC systems than on the MC680x0, the 
value of x had better not change between function calls. 

The best strategy is to write FORTRAN code that does not depend on the order of 
parameter evaluation. 
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4.1. Porting Issues 


Data Alignment 


Record Alignment and 
Padding 



Porting Pascal Programs 


Here are some architectural considerations that may cause problems when port- 
ing Pascal programs to SPARC. 

Since Pascal has no type casting mechanism like the one in C, there should never 
be data alignment problems caused by casting pointers to small objects into 
pointers to larger objects. 


However, it is possible to simulate the effect of type casts by the use of the vari- 
ant record mechanism. For example, the following program may fail to work as 
you would expect: 


r 

program WontWork; 



type 

foo = record 

case boolean of 

false : 

(Iptr : 
true : 

(Cptr : 

end; 

var 

bar : foo; 

"integer) ; 

"char) 


begin 

new (bar .Cptr) ; 
bar. Iptr" := 0; 



end. 

V 


> 


On the MC680x0, each record is aligned on halfword (even) boundaries. On 
SPARC machines, the alignment requirement of a record is the same as that of 
its most strictly aligned component. For instance, a record containing only 
char members has no alignment restrictions, whereas a record containing a 
real must be aligned on an 8 -byte boundary. 

On the MC680xO, records are padded internally so that integers and reals 
always begin on an even boundary. For instance, a record containing only one 
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12 Porting Software to SPARC 


char and then an integer has three bytes of padding after the char, so that 
the integer is aligned on a 4-byte boundary. 

On the MC680x0, records are padded on the end to contain an even number of 
bytes. On SPARC machines, records are padded on the end to the appropriate 
alignment boundary. For instance, a record containing only char members is 
unpadded, whereas a record containing an integer but no real is padded 
out to a 4-byte boundary. 

Because of the three considerations above, members of a given record may have 
different offsets on SPARC machines than on the MC680x0, and the record as a 
whole may have a different size. Even though basic data types (machine types) 
are represented identically on the two machines, constructed data types may be 
different. Note that records retained in memory are fine; problems occur only 
when records are actually written out. 

Here is an example of two records that could not be written on one processor and 
read on the other (though in memory they would be fine): 

Figure 4- 1 Records that Result in Non-Portable Binary Files 
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There are three solutions to this problem. First, you could write a program to run 
on each processor that would create binary files of records according to the 
requirements of that processor. Pascal versions of TeX, for example, come with 
programs to create font metric files on different machines. 

Second, if a record must be portable across machines, Sun’s external Data 
Representation (XDR) would be the best solution. The best way to write a record 
on one machine that is to be read on others is to use an XDR standard representa- 
tion for the data. See the section entitled “XDR Protocol Specification” in the 
manual Networking on the Sun Workstation. Unfortunately calling XDR routines 
from Pascal is not yet supported. 

Third, you could manually arrange the elements of a record, from the most to 
least restrictive alignment requirements, then insert explicit fill elements as 
needed. Records are often designed in this manner anyway, with the largest ele- 
ments at the beginning. 
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Order of Parameter 
Evaluation 


Out-of-Range Shifts 


The order of evaluation of parameters to a procedure or function is not defined by 
the Pascal language, and is different in SPARC Pascal compilers than in Sun’s 
MC680x0 Pascal compilers. Let’s consider this example: 




\ 

tally (func (x) , eval (x) ) 


v 

y 


Since the functions f unc ( ) and eval ( ) , which are arguments of procedure 
tally (), are evaluated in a different order on SPARC systems than on the 
MC680x0, the value of x had better not change between function calls. 

It is never a good idea to make assumptions about the order of parameter evalua- 
tion. The best strategy is to write Pascal code that does not depend on any side 
effects of parameter evaluation. 

Sun’s Pascal compiler has non-standard extensions to perform bit operations on 
integral types. The logical shift (right and left) is analogous to shifting 
unsigned quantities in C, whereas the arithmetic shift (right and left) is analo- 
gous to shifting signed quantities in C. 


Table 4-1 Bitwise Operations in Pascal and C 


Pascal 


C 

lsl (x. 

count) 

unsigned 

x « count; 

lsr (x, 

count) 

unsigned 

x » count; 

asl (y. 

count ) 

int y « 

count; 

asr (y. 

count ) 

int y » 

count; 


With any of these operations, a count greater than or equal to the size of the 
left-hand operand yields machine-dependent results. Many programmers are not 
aware of this, and assume that a right logical shift by a large amount yields zero. 
This is often true on MC680x0 machines, because the shift count is interpreted 
modulo 64. This is true less often on SPARC machines, because the shift count 
is interpreted modulo 32. 

The best strategy is to avoid shift counts greater than the size of the affected 
operand. A negative shift count won’t yield sensible results on either machine, 
of course. 


Uninitialized Local Variables Naturally, beware of uninitialized local variables; they may come up with dif- 
ferent values on different machines. The use of uninitialized variables is a poor 
programming practice. The Pascal compiler pc flags uninitialized local vari- 
ables, but not uninitialized global variables, since external procedures may ini- 
tialize any global variable. 

4.2. Conclusion Well-written portable Pascal programs should mn on SPARC machines as well 

as on any other machine. Non-portable programs, by definition, may present 
problems when transported to SPARC machines, or to any other machine. There 
is no substitute for good program design. 
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